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d-tree Version 3.1 Release E2 
Update Information 


The following notes refer to new features that have been added to d-tree since 
release D2. These changes may not yet be noted in the documentation. 


1) Field Range Checking 


The ability to place a RANGE check on a field has been added to the EDIT 
ability. This was done by enhancing the TABLE edit type. Along with single 
values, ranges can be defined in a [a-z] format as elements of the table. Ranges 
are supported for all field types except strings and dates. Refer to the file named 
"refcard.doc" on distribution disk for more information on range syntax. 


EDITS(mas*er) 

Must Enter Field act_code MANDATORY 

This record Already Exists act_code DUPKEY act_code_idx 

this entry not correct act_bal TABLE 1.060 3.60 (188. 68-2GQ0. BBL 
this entry not correct act_char TABLE A BC [(H-O) 

this entry not correct act_uchar TABLE 1 Z2 3 

this entry not correct act_code TABLE AA BB CC 


Ranges Are now Allowed in TABLE Edits 
See the file “refcard.doc™ on the distribution 
diskettes for more information. 


2) Integer Date Field Support 


d-tree now properly handles dates that are stored as long integers 

(i.e.: RTDATE type). The logic to handle the conversion from integer to string 
and back again is in place. This allows dates to be presented on an IMAGE ina 
string format such as MM/DD/YY and then be stored as a long integer. All 
reasonable date formats are supported , including a four digit year. The format 
of the string is required in order to properly convert the date into a long integer. 
(i.e: DD/MM/YYYY as opposed to YY-MM-DD). This format is defined using 

input attribute field masks within the FIELD ability section. The new mask charac- 
ters of M,D,and Y have been added to provide this support. 


IMAGEC master) {LSTFLD_ADUANCE} 
Date Input field on screen. 
Date: Defined RTDATE type 


FIELD(C master) 
“* Symbol Name Input Attribute Output Attribute Input Order */ 
date field NONE {(YYYY/MNN’DD} NONE 1 “7* Date 7 


{NM-DD-YyY} 
{MMN-DD-YYYY} + Any Combination with year either 
C(DD/MN“YY} 7 or YYYY. 


When the date (Cin string form) is entered from the screen, the neu 
date input masks are used to convert the entry into a long integer. 
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3) EDITS: MANDATORY IF and "OR'"ing capability 
Three New features have been added to the EDITS ability: 


A new edit type of MANDATORY _IF provides a way to indicate that a field is 
mandatory if another field is not blank (ie: if one field is entered the other is man- 
datory). To define which field will be checked for an entry, you enclose its sym- 
bolic name in brackets {} following the MANDATORY IF keyword. See illustra- 
tion below. 


The means to "OR" edits has been added to the EDITS ability. Placing the 
keyword "OR_WITH_NEXT" as the error message for an edit, specifies that this 
edit is to be "OR’d" with the next edit. 


The new keyword "LOOKUP_ONLY" has been added to the VALIDATE edit. Plac- 
ing this keword after the map and scan identifiers provides the same lookup 
capability as a regular VALIDATE edit, but relaxes the "equal hit" edit. This al- 
lows a key that supports duplicates, to be used for "lookup" purposes. 


EDITS( master) 

“7* Error Message symbol name edit type edit information */ 

Must Enter Complete Code MAND_FILL 

Must Enter County Code MANDATORY_IF (field symbol} 

This county already exits DUPKEY C_Num 

OR_WITH_NEXT VALIDATE exlidx cmap cscann prefix 
Code must exist in File VALIDATE exZidx cmap cscann prefix 
None VALIDATE ex3idx map scan LOOKUP_ONLY 


Nev Features in EDITS: 


a) a neu edit type of MANDATORY_IF has been added. This field uill be 
MANDATORY if there is a value in the field supplied in brackets {}. 


There is now an “OR” capability in edits. Place the keyuvord 
“OR_WITH_NEXT”’ as the error message for an edit that is to be or’d 
with the next edit. “OR” edits may be stacked, vith the first edit 
without the “OR_UWUITH_NEXT” keyuvord as the final or condition. The 
error message for this edit is displayed if all “OR'’s fail. 


The “LOOKUP_ONLY” keyvord will relax the “equal hit edit. while 
allowing a “lookup” capability. The error message is necessary, 
although will not be displayed. 


5) DEFAULTS: List type default ; field default values 
Two new features have been added to the DEFAULTS ability: 


a) A new defaults type has been added known as a default list type. The best 
way to describe this is through an example. We want to present the user with a 
field that has a limited amount of valid entries. In this case we'll use a field 

where the user is to specify a baud rate. Valid values are limited to 300, 1200, 
2400, 9600, and 38400. We could simply place a TABLE edit on this field, but 
this would necessitate the user enter the value. Rather, we would prefer to 
default the field with a valid value, and allow the user to simply hit the space bar 
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to change the value to another valid entry. In this case we will default the field to 
300 baud, and each time the user hits the space bar the value will change from 
300 to 1200; from 1200 to 2400; from 2400 to 9600...from 34400 to 300...etc. 
See the illustration below. Note: an input attribute of NOCHANGE must be 
placed on the field in order for the "space bar change logic" to take effect. This 
is done in the associated FIELD section. 


b) Before this release, the value used to default a field could only be a literal 
keyed in the d-tree script. We have now added new support where the value 
used to default a field can be the contents of another field. This is done by plac- 
ing the symbol name of the other field (within brackets with no spaces) as the 
default value. See illustration below: 


DEFAULTS( master) 
7* Symbol Name Type of defaults Defaults value */ 
office DFALT_KEY Reno Office 
office date INIT SYSDATE 
office_time DFALT_KEY SYSTIME 
baud_rate DFALT LIST 3868 1206 2488 3688 38488 
of fice_name DFALT_KEY Coffice} “* put field symbol in { } x7 


Tuo Neu DEFAULT features: 


a) Enter a list of valid values. The field will be initialized with the 
first value. When users enter this field, they can hit the space 
bar. The value of the field will change to the next entry in the list 
each time the space bar is hit. 


The default value can now be another field value. Simply place the 
desired field’s symbol name within brackets {} without any spaces. 
When the default is executed, the value of current value of this field 
will be “defaulted” into your destination. 


4) Menu Enhancements 


Three new features have been added to the menu support. 


The first two features pertain to cursor movement (option selection) for lotus 
style menus. 


a) The user now can hit the space bar to move to the next option. 
b) Support to allow the user to enter the first character of a desired option has 
been added by means of the new input attribute GOTO in the FIELD ability. 


The third new feature may be illustrated as follows: While on a certain menu op- 
tion, it may be helpful to display "help" information pertaining to the option. This 
"help" should automatically change when the user moves from option to option. 
This effect is provided by the new AUTO_ HELP input attribute in the FIELD 
ability working in conjunction with the HELP ability. Place the AUTO_HELP at- 
tribute on the desired field. Add the "help text" via the help ability as shown 
below. When the cursor enters this field, the help text will automatically be dis- 
played, without the need for the user to hit the help key. 
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asee=Small Project Accounting 
Thu Nov @3 System Master Menu 82:52:39 


Posting Menu 


Report Menu 


Do Your Daily Posting AUTO_HELP text] 


a) On a Lotus style menu you may nou hit the space bar to go to next option 
Example: Hit space bar vill move BAR to Report Menu. 


b) Using the neu GOTO input attribute allows jumping to options by entering 
the first letter of the option. Example: Hitting “O" will take us to 
“Other” option. 


Using the new AUTO_HELP input attribute allous option description text 
to be displayed while on an option. As you move from option to option 
this text will change. 


FIELD( menu) 

7% Symbol Name Input Attribute Output Attribute Input Order */ 
menula GOTO AUTO_HELP NOCHANGE INPUTRI 1 
menulb GOTO AUTO_HELP NOCHANGE INPUTRI z 
nenulic GOTO AUTO_HELP NOCHANGE INPUTRI 3 


Allow user to hit first character of another 
menu option to GOTO that option. 

Display Help text automatically when entering 
this help. 


HELP( menu) 


“7* Help Text Field Symbol »*/ Help text defined here. 
Do Your Daily Posting menula 


Go To Report Menu menulb 
Describe Other Here menulic 


6) Prompt Ability 


The scan name was mandatory in the PROMPT ability syntax in the prior 
release. The DT_PRMPT function can be very useful in creating key targets, 
without the use of a scan. Therefore we have allowed the keyword of NONE to 
be used as a scan name in the PROMPT ability syntax. 


PROMPT( master) 
USES_IMAGEC prompt ) 
“7* key symbol name  scann name fields for target prefix */7 
C_Num NONE cou_cod 


C_Nam master cou_nane 
NONE master option 


No scann defined. 
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7) IFILS: DODA can be defined in script 


d-tree now supports the ability to define the fields in the data object definition 
array (DODA) through a d-tree script, as opposed to being hard coded within 
the program. This is done by use of the new "PGM_ FIELDS" keyword within the 
IFILS ability section. Simply enter your program fields (DODA elements) follow- 
ing the syntax illustrated below. At this point in time, d-tree does not support 
part of the DODA being hard coded, while other parts are dynamic (defined in a 
d-tree script). The ability to define fields in a dynamic manner is a powerful con- 
cept. The field types follow r-tree’s nape convention and can be found in the 
file “rtdoda.h". 


IFILS 


PGM_FIELDS 
7* doda symbol name field type field length »*/ 
name STRING 11 
address STRING 38 
balance RTDFLOAT 8 
quantity RTINTZ Z 


d-tree now supports the ability to define a DODA from a d-tree script. This 
is done with a new keyword that has been added to the IFILS ability. By 
entering PGM_FIELDS within the IFILS ability section the DODA or 

in othervords, program fields can now be defined. 


IFILS Change: The "DICTIONARY" capability discussed in the IFILS section in 
the d-tree manual has been changed. There is no longer a "DICTIONARY" 
keyword within the IFILS ability. Due to the power and flexibility that can be ob- 
tained by accessing definitions from a data dictionary, this capability has been 
moved to its own ability type. Access to the data dictionary at runtime can now 
be obtained by means of the new DATA DICTIONARY ability. See below. 


8) New Data Dictionary Ability 


A new ability to allow file definitions to be defined from within a d-tree script has 
been added. By following the syntax shown below, in conjuction with the new 
function call DT DDICT, file definitions can be accessed at runtime. 
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| DATA_DICTIONARY( myfiles) 


DICTIONARY diction.dta 
FILE_NAME filenam.dta 
VERSION 1.8 


File definitions used in a program can nou be defined from a d-tree script. 
A nev d-tree function called DT_DDICT(C ref) has been added to the toolbox. 
By calling this function from vithin your progran, file and index 
definitons (this includes IFIL, IIDX, ISEG, and DODA definitions) are 
svuapped into memory at runtime. Example: Consider the definition above in 
your d-tree script and the following line of code in your c progran. 


if Cuerr_cod=DT_DDICT¢( DT_INAMEC “myfiles”))) 
printf "’Could no get file definition from data dictionary”): 


DT_DDICT will open the data dictionary with the File name of “diction.dta”. 
It will then try to read in the definitions for file “filenan.dat” version 
1.0. (data dictionary stores multiple file definitions vith version control) 


9) Parsing Error Help. 


When an error occurs while parsing a d-tree script, the ability name, as well as 
the ability number will now be displayed. If you started at the top of the script 
and counted all ability definition sections (count all ability types, not just the 
type that had the error), until you hit the ability number shown, you would be on 
the section where the error occurred. 


C:\DT >posting <——————_——— Run. your Progran. 
token=" tamntx® <«<—————_____—_———_- Last Token hit in script. 


a a Ability that uas being parsed. 


‘“FIELD> (the #7 ability in the script) has an Error 


Error Occurred During Parse Error=180ihex 4106 


CIXDT > c c-tree error or 
d-tree error 


10) GROUPS - New High Level Group In/Out. 


The function DT GPHIN (group high level in) and DT GPHOT (group high level 
out) have been added to d-tree. DT_ GROUT provides a means to store a script 
definition into a "group" file. DT_GPHIN is used to access the definition and 
swap it back into memory. See DT GROUT.C and DT GROUP.C. 
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11) DT_FUNCP - Set Function pointers 


As we begin work to bring the code size down in d-tree, we have started to use 
a number of function pointers. These pointers are initialized for you by d-tree 
when ability definitions are being parsed in, or they are hard coded. If ability 
definitions are being swapped in though the use of GROUPS, you are respon- 
sible for initializing these pointers. The function DT FUNCP has been provided 
to perform this initialization. This function must be called at the top of you 
program just after DT _SETTY to set the function pointers. THIS ONLY APPLIES 
IF YOU ARE USING GROUPS. Note: The current version of this function initial- 
izes all pointers. You may want to create your own version of this function, only 
specifying the functions pointers your program will be utilizing, in order to 
decrease code size. The function can be found in the source file DT FUNCT.C. 


12) Easy way to rebuild indices from the catalog 


We have added an easy way to provoke a file rebuild. The Reformat option on 
the catalog’s data dictionary menu has been enhanced. Now called the "Refor- 
mat/Rebuild" option, this selection allows files to be chosen for rebuild. By 
rebuild we mean: c-tree’s RBLIFIL will be called for each file chosen. Simply 
place an '"R" next to the file to be rebuilt as shown below: 


Sun Nov @6 FairCom 62:59:41 
File Reformatting’Rebuild Utility 
Sel Name Version Description System 
account Account Master MISC 
{CRicustomer customer IMPORTED 
distrbut Distribution Detail File MISC 
R project project IMPORTED 
transact Transaction File MISC 
R vendor Vendor Master MISC 


The customer, project, and vendor files will be rebuilt. 


For each file chosen, c-tree’s RBLIFIL will be called 
to rebuild file header information, as well as reconstruct 
the file indices. 


Enter (T)o 7 (F)rom for Reformatting Data or (R)ebuild to rebuild indices 
Press “ESC ESC’ to EXIT or *POST’ key to begin Reformat/Rebuild 


REO ERR tare Ae NT ee Eee ae PEON ey TE nec RE Reni Lo CIO Ne te Tn ery eee eR ee TE 
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13) Running Clock (DOS INSTANT ONLY) 


We have enhanced the time display to now show a running, 12 hour clock. This 
is only supported in the DOS environment when using INSTANT screens. We 
- hope this is not a limitation in future releases. 


14) DT_INIMG - Initialize fields for a certain IMAGE 


The function DT_INIMG function has been added to allow initialization of all 
fields that pertain to a specific IMAGE. Example: 


DT_INIMG(1); 


will look for all fields on IMAGE number 1 and initialize them. This function may 
be found in the source module DT_IMAGE.C. 


15) DT_TXFLD - return the value a field in text form. 


The function DT _TXFLD has been added for the following purpose: Given a text 
pointer, followed by a FIELD pointer (type DTTFIELD), this function will place 
the value of the field into the buffer pointed to by the text pointer. This value will 
be in the same form as if it were sent to the screen. (masks included, numeric 
to ascii, etc.). 


16) SCAN Ability - Bar Select and Add Mode. 


Two very nice features have been added to the SCAN ability. The most current 
scan module can be found in the "patches" directory on disk #5. Because of the 
usefulness of the following features, we pushed to get them in this release. Al- 
though the features are complete, we have not thoroughly tested them in all en- 
vironments. The previous version of the DT SCANN.C module can be found on 
disk #3 if found necessary. We suggest starting with the latest (disk #5 version 
of DT SCANN.C) which contains the following features: 


First the ability to define an alternate way to select a record. As opposed to the 
user being displayed a list of numbered records and having to enter the number 
of the desired record, d-tree now supports defining a "SELECT BAR". This 
means that records can be selected by positioning a reverse image bar on the 
desired record and pressing ‘return’. This approach is supported as follows: a) 
the image reference provided for the IMAGE_INP definition should be the same 
as the IMAGE_ROL definition. b) The new keyword "SELECT BAR" must be 
added to the SCAN definition section. See illustration. 
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Sun Nov @6 MISC System 84: 42:17 
Transaction File 


reference number: 1122608 

type: C 

date: 18/31/788 

amount: ' 1888.88 

description: Another Modem Phone Bill 
customer’vendor code: 


Breakdoun Amt Account Pro ject 

hart of Accounts 

Cash In Bank 

Travel A lookup was provoked. 

Entertainment A POP-UP selection 

Phone Expense . Window in displayed with 

Equipment Page Up’Douwn and Up/Down 

Utilities Keys supported to find 
Press ESC ESC to EXIT selection. 


The script to provide this selection looks like this: 


posting. dts see ee 


IMAGECacthead) (qt UD Rea SES FA} 
*Note the highlighted keyvords 


+Transaction File 


Presse ESC ESC to EXIT 


+ 


lene Tastee eaCCLAR BLOCK? {BASE _ROW=12Z} {LSTFLD_ ADVANCE} {FRSFLD_BACKUP) 


FIELDCactroll > 
7* Symbol Name Input Attribute Output Attribute Input Order I/0 Special * 


acode NOCHANGE NONE 1 “* account code */ 
adesc PROTECT NONE 2 7% desc */ 


The scan ability still supports selecting records by entering a reference number 
when the image references for IMAGE_ROL and IMAGE _ INP are different. We 
have enhanced this selection. You may now enter either the record’s reference 
number, or point to the record for selection. The new point feature (as well as 
the character used to "point") are defined by the #define SCAN POINT at the 
top of DT_ SCANN.C. Commenting out this #define will relax the "point" charac- 
ter and "point" selection ability. 


Fe eee =e ret ae Sen Ratt cece ORCAS MS RRS TE OL IPE EES AI aE DN Ee EE ECR ee eS ae ee ce 
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Sun Nov 66 MISC System O64: 41:31 
Transaction File 


Select 
1 Ol 111111 
Z B2 LLLLLAL 
3 83 
4 84 
S 8S 


Point Character as defined by 
SCAN_POINT in DT_SCANN.C. Can hit 
"RETURN’ to select record 48. 


Enter Desired Option:( 1] 
Press ESC ESE £6 EXIT 
FairCom (c) 1988 


The second feature allows the user to enter into an "ADD MODE" for the file that 
is being scanned. Example: Say we are entering a customer number when 
keying invoices. We enter a '"?" in the customer id field to do a lookup into the 
customer file. We discover that this is a new customer who should be added to 
the customer master file. While in the scan screen, d-tree now supports the 
ability to enter an "ADD MODE" into the customer file. The new scan keyword 
"IMAGE_ADD" has been added for this purpose. Providing the image to be used 
for the "ADD", will allow the user to hit "F1" from the scan screen. This will 
provoke the add process, which, once complete, will return to the scan. See il- 
lustration below: 


SCANCactscan) {IMAGE _OUT=acthead} CIMAGE_ROL=actroll} CIMAGE_INP=actrol1} 
{SELECT_BAR} {ROLL_LINES=6} CIMAGE_ADD=actadd} 


f | eae 


New Keyuord 


DT_SCANN.C 
Maisisisisisisisiaisininininisiniainisisisisisisisisisisiaisisiaiaiaicai. LLL LCCC CLOUT LCCC TCT TT 
COUNT DT_SCUAT( message, kbd,from) “* what to do next after input *7 

DTTMESAG message; 


COUNT kbd: 7* uhat happened 7 
COUNT from; “7 where from 7 
c 


COUNT DT_SCGETC); Fil defined here to be used to 


go into Add Mode. Change code 
suitch (kbd) here if desired. 
{ 
case DTKBF1: 


DT_ADDMD( message- >datno, message->sptr—->imgadd): 
return(@); 
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BUGS FOUND 


The following list contains areas where bugs were found. If you were experienc- 
ing problems in any of these areas, we hope we've solved the problem. 


e Default "AUTO DUP" feature. 

e Numeric input of fields(delete key problem). 

e System hanging when input masks were defined for numeric fields. 
e TABLE edit problem. 

e IMAGE parsing problems (TABS in IMAGE now ok). 
e r-tree front end prompt parsing error. 

e Window overlapping problems. 

e Ending comment left out of code. 

e Unix/Xenix termio problem. 

e Help ability bug. 

e Page Up/Down problem in subfiles. 

e Hard coded hooks problem. 

e Subfile map problem. 

e Hard coded input fields. 


CATALOG 


The Catalog program had a number of bugs that were fixed, primarily where 
"core dumps" where occuring in the Xenix/Unix world. Below are some of the 
more obvious problems that have been fixed: 


e RECORD LENGTHS: When a field length was entered into the data 
dictionary, the record length was being calculated based on this field 
length without taking the field type into consideration. I.E: user keys an 
integer field and says it is 5 long. The length of 5 was being used not 
only to control the input length that was used when creating a d-tree 
script , but also as the length to determine record length. The result 
was invalid record lengths. 


Now the catalog acts as follows: 


For all field types except char arrays(strings): the length keyed in the 
data dictionary will be the length used to draw input lines (i+): when 
creating scripts. The length used to calculate record lengths will be 
based on the field type, not on the field length. For char arrays(string): 
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then length will be the length used to calculate record length, and the 
input lines (____) placed in a d-tree script will be one less than the field 
length. The last byte of a char array is used for the NULL byte. 


e User Defined Segment Modes. 

e To/From Reformat File Problems. 

e Zero Length Parameter File being Created from the catalog. 

e Text In/Out Problem. 

e Creating default d-tree script: decimal position now added to script. 


We would like to thank all the users who mave been so helpful in both pointing 
out problem areas, as well as coming up with good new ideas. We are not 
going to sit here and take all the credit for the new features that have been im- 

_ plemented in this release. (we will take blame for the bugs in the last release). 
It's your positive feedback that makes the coding worthwhile. We wish we could 
have implemented all the useful suggestions, but as you well know, it had to be 
cut off sometime. Thank you again, and please continue to communicate bugs, 
suggestions and/or enhancements. 


For your information, the areas at the top of the development list are: 
1) Smaller Code Size. 

2) Memo Fields (variable length word processing like fields). 

3) Group Examples. 


We list these for information only. We hesitate to give time frames. We en- 
courage users who are in need of a feature to get advice from us as to how to 
approach the problem, and not to wait on us. We can only promise consistent 
hard work in our development lab. 
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